package com.logos.musicframe.service;

import com.logos.musicframe.entity.SongPlayHistory;
import com.logos.musicframe.resp.SongPlayHistoryResp;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;

import java.util.List;

/**
 * 播放历史(SongPlayHistory)表服务接口
 *
 * @author logos
 * @since 2025-06-16 10:31:56
 */
public interface SongPlayHistoryService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    SongPlayHistory queryById(Long id);

    /**
     * 分页查询
     *
     * @param songPlayHistory 筛选条件
     * @param pageRequest      分页对象
     * @return 查询结果
     */
    Page<SongPlayHistory> queryByPage(SongPlayHistory songPlayHistory, PageRequest pageRequest);

    /**
     * 新增数据
     *
     * @param songPlayHistory 实例对象
     * @return 实例对象
     */
    SongPlayHistory insert(SongPlayHistory songPlayHistory);

    /**
     * 修改数据
     *
     * @param songPlayHistory 实例对象
     * @return 实例对象
     */
    SongPlayHistory update(SongPlayHistory songPlayHistory);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    boolean deleteById(Long id);

    /**
     * 查询用户历史播放记录
     * @param userId
     * @return
     */
    List<SongPlayHistoryResp> queryByUser(Integer userId);

    /**
     * 新增播放历史
     * @param userId
     * @param songId
     * @return
     */
    Boolean add(Integer userId, Integer songId);
}
